Controller Developers
Controller Definition & Mapping files for VirtualDJ
A controller in VirtualDJ is defined by two files, a "definition" file and a "mapping" file.
The definition file gives a human-readable name to every MIDI code or HID zone.
The Mapping file associates each name with an action in VDJscript.
Many controllers already have a definition embedded inside VirtualDJ.
If you have a controller that is not recognized natively by VirtualDJ, or if you are a manufacturer working on a new controller, it is very easy to create a new definition file for this controller.
Definition
The definition files are standard XML files, and must be installed in the MyDocuments/VirtualDJ/Devices/ folder on PC or /users/YOURNAME/Documents/VirtualDJ/Devices on Mac.
The syntax of the definition file depends on the interface used (HID or MIDI):
Note : If you wish to build a custom definition for a natively supported Controller, you will need to name the definition file as force-whatevername.xml in order the built-in definition to be bypassed.
Mapping file
The Mapping files are also standard XML files, and must be installed in the MyDocuments/VirtualDJ/Mappers/ folder on PC or /users/YOURNAME/Documents/VirtualDJ/Mappers/ on Mac.
Mapping files for the built-in (Native supported) controllers will only appear in this folder if they have been modified by the user via CONFIG -> Mappers in VirtualDJ.
Related Topics:
- FAQ : Controller Identification
- FAQ : Differences between HID and MIDI protocols
- FAQ : How to implement a HID firmware
- FAQ : MIDI Not Responding